Skip to main content
DELETE
/
users
Delete a user
curl --request DELETE \
  --url https://your_a2_service/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "budget": 123,
  "campaign_count": 1,
  "creative_count": 1,
  "credit": 123,
  "email": "jsmith@example.com",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "is_superuser": true,
  "is_verified": true,
  "name": "<string>",
  "password": "<string>",
  "permissions": {},
  "placement_count": 1,
  "preferences": {
    "etc": {
      "language": "ko"
    },
    "notification_methods": {
      "email": true,
      "slack": false,
      "sms": false
    },
    "notification_methods_data": {
      "slack": "<SLACK_WEBHOOK_URL>",
      "sms": ""
    },
    "notifications": {
      "attribute_deleted": true,
      "campaign_finished": true,
      "publish_approval": true,
      "publish_request": true
    }
  }
}'
{
  "budget": 123,
  "campaign_count": 1,
  "creative_count": 1,
  "credit": 123,
  "email": "jsmith@example.com",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_active": true,
  "is_superuser": true,
  "is_verified": true,
  "name": "<string>",
  "permissions": {},
  "placement_count": 1,
  "preferences": {
    "etc": {
      "language": "ko"
    },
    "notification_methods": {
      "email": true,
      "slack": false,
      "sms": false
    },
    "notification_methods_data": {
      "slack": "<SLACK_WEBHOOK_URL>",
      "sms": ""
    },
    "notifications": {
      "attribute_deleted": true,
      "campaign_finished": true,
      "publish_approval": true,
      "publish_request": true
    }
  },
  "role": "advertiser"
}

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Represents an update command for a user.

​
budget
number
required

The total budget currently available to the user.

​
campaign_count
integer
required

The number of campaigns owned by the user.

Required range: x >= 0
​
creative_count
integer
required

The number of creatives owned by the user.

Required range: x >= 0
​
credit
number
required

The total credit currently available to the user.

​
id
string<uuid>
required

The ID of the user.

​
name
string
required

The name of the user.

Required string length: 4 - 32
​
permissions
object
required

The permissions information of the user.

Examples:
{}
{
  "admin": [],
  "advertiser": ["permission"],
  "analytic": ["campaign"],
  "audience": [],
  "audience_attribute": ["r"],
  "audience_segment": ["r", "w"],
  "campaign": ["r", "w"],
  "creative": ["r", "w"],
  "placement": ["r"],
  "retailer": []
}
{
  "admin": ["list_advertisers", "budget"],
  "advertiser": [],
  "analytic": ["placement"],
  "audience": ["r"],
  "audience_attribute": ["r", "w"],
  "audience_segment": ["r", "w"],
  "campaign": ["r"],
  "creative": ["r", "w"],
  "placement": ["r", "w"],
  "retailer": ["approval", "permission"]
}
​
placement_count
integer
required

The number of placements owned by the user.

Required range: x >= 0
​
preferences
object | null
required

Represents a user preferences.

​
email
string<email> | null

The email of the user.

​
is_active
boolean | null

Is the user active.

​
is_superuser
boolean | null

Is the user admin.

​
is_verified
boolean | null

Is the user email is verified.

​
password
string | null

The password of the user.

Response

Successful Response

Represents a read command for a user.

​
budget
number
required

The total budget currently available to the user.

​
campaign_count
integer
required

The number of campaigns owned by the user.

Required range: x >= 0
​
creative_count
integer
required

The number of creatives owned by the user.

Required range: x >= 0
​
credit
number
required

The total credit currently available to the user.

​
email
string<email>
required

The email of the user.

​
id
string<uuid>
required

The id of the user.

​
is_active
boolean
required

Is the user active.

​
is_superuser
boolean
required

Is the user admin.

​
is_verified
boolean
required

Is the user email is verified.

​
permissions
object
required

The permissions information of the user.

Examples:
{}
{
  "admin": [],
  "advertiser": ["permission"],
  "analytic": ["campaign"],
  "audience": [],
  "audience_attribute": ["r"],
  "audience_segment": ["r", "w"],
  "campaign": ["r", "w"],
  "creative": ["r", "w"],
  "placement": ["r"],
  "retailer": []
}
{
  "admin": ["list_advertisers", "budget"],
  "advertiser": [],
  "analytic": ["placement"],
  "audience": ["r"],
  "audience_attribute": ["r", "w"],
  "audience_segment": ["r", "w"],
  "campaign": ["r"],
  "creative": ["r", "w"],
  "placement": ["r", "w"],
  "retailer": ["approval", "permission"]
}
​
placement_count
integer
required

The number of placements owned by the user.

Required range: x >= 0
​
preferences
object | null
required

Represents a user preferences.

​
role
enum<string>
required

User role enum.

Available options:
advertiser,
retailer,
admin
​
name
string | null

The name of the user.